Map Parameters

All map parameters are contained on the Parameters tab of the ‘Edit Map’ dialog box. You may find that, depending on your choice of map, certain parameters are not relevant or available.

To view map parameters:

Click or select Analysis > Maps to display the ‘Edit Map’ dialog.
Click on the map whose parameters you want to view in the list of maps in the left-hand pane.

The following sections describe the various settings on the Parameters tab.

Metric

This drop-down menu contains the following settings:

Occupancy – the number of Entities occupying or being in close proximity to a unit of space at any one time.
Occupancy Time – the cumulative length of time that Entities have occupied or been very close to a unit of space.

The following Entity experience metrics are averaged for all Entities close to or inside a unit of space (the final four settings only appear if you included this data when you saved the ‘res’ file or if you are running an on-line analysis).

Speed – the average speed achieved by Entities close to or inside a unit of space.
Entity Density – the density approximately computed for each Entity by drawing a circular area of 1.5 metres around them, identifying the accessible space inside that area and then calculating the number of Entities inside that area including themselves.
Total Distance – the total distance travelled by an Entity since the playback began.
Inconvenience – a measure of walking experience comparing actual length of journey to an Entity’s preferences.
Frustration – a measure of walking experience comparing actual speed and time to an Entity’s preferences.
Discomfort – a measure of walking experience comparing perceived congestion to an Entity’s preferences.
Dissatisfaction – a ‘holistic’ measure of each Entity’s walking experience compared to their respective preferences; it encompasses inconvenience, frustration and discomfort.

The following Entity metrics are only shown for enabled Social Distancing metrics (see Social Distancing Metrics). These metrics are also averaged for all Entities close to or inside a unit of space:

SD[n] Proximity Count – for an entity, the number of other entities within social distance SD[n].
SD[n] Current Breach Duration – for an entity, the length of time that the count of other entities, above a predefined threshold, have been within social distance SD[n].
SD[n] Total Breach Duration – for an entity, the total duration of all recorded Entity Proximity Breach Times within social distance SD[n].

SD[n] refers to the enabled numbered SD metric, e.g., SD1, SD2, or SD3.

Area

Select the Area of the model you want to apply a Map to. This drop-down menu lists ‘Whole Model’ along with any Analysis Zones you may have placed in the simulation. It also has the option 'Alternative Regions Only', which you can select if you decide to apply Value Ranges to portions of the Map defined by Stairs, Escalators or Analysis Zones. See Using Alternative Value Ranges for more information.

Having selected an area, you can then choose to ‘Use smoothing’ or not:

Use Smoothing – leave this box unchecked to prevent blending, thus keeping the Range's colours distinct (useful in Maps where the colours may represent a pass or fail against a standard).
- Check this box to display a gradation of the available colours (useful in Maps where specific ranges are not crucial).
- The following illustrations show a Density Map with 'Use smoothing' unchecked (left-hand Map) and with it checked (right-hand Map).

The orange represents Fruin's LoS 'E' which, in the left-hand example is quite expansive; with 'Use smoothing' switched on the Map clearly illustrates that most of the area in fact registered densities at the lower end of that Level of Service.

Zone of Influence

LEGION Maps are based on the concept of a zone of influence which is effective around each Entity. This is necessary to provide a precise definition of which Entities a unit of space should consider when computing its occupancy and related metrics.

Note: If, in any frame, a unit of space lies within the Zone of Influence of more than one Entity, the reported value for that time-step is: an average over all Entities if the metric is an experience metric; a total value if the metric is occupancy; and the most recent time when the unit of space was occupied if the metric is occupancy time.

The two options for this parameter are Fixed Radius and Entity Trail:

Fixed Radius – this setting means that the Entity will influence a circular area around it defined by the radius you enter here.
- For most Maps it is initially set at 1.5 metres, but you can increase or decrease this value.
- Maps showing a social distance metric use half that metric’s social distance, and the radius cannot be changed here.

This setting is appropriate for all Maps using Entity experience metrics: the colour of each unit of space represents the experience an Entity would have if it were 'parachuted' into that precise space.

Entity Trail – this setting means that the Entity will influence the space it traverses. This ensures that all areas an Entity passes over are represented in the Map.

It is therefore appropriate for occupancy-based Maps (i.e. Space Utilisation and Evacuation Time Maps).

Accumulation Method

This parameter refers to the method that each unit of space uses to accumulate data over time, from the simulation start time (or restart time) to the current time-step. Some of the methods require you to enter a value, such as a Cut-off value or a Decay coefficient.

Note: Accumulation Method does not apply to Occupancy or Occupancy Time and is not available if either of these are selected as the Map's Metric.

The settings within this parameter are:

Min – records the minimum value of any experience metric registered since playback began.
Max – records the maximum value of any experience metric registered within a unit of space.
Mean Value – records the mean value of an Entity experience metric registered within a unit of space. This accumulation method disregards idle periods, so it is good for identifying spikes.
Count Above the Cut-Off Value – records the number of time-steps from the start of the simulation in which the value of an Entity experience metric exceeds your specified cut-off value.
Count Below the Cut-Off Value – records the number of time-steps from the start of the simulation in which the value of an Entity experience metric falls short of your specified cut-off value.
None – values are not accumulated; they are overwritten when any new value is registered within a unit of space.
Exponential Decay – the values recorded by a unit of space decay over time according to the Decay coefficient entered here (0.1 is a suitable coefficient for most situations).
Mean Value with Zeros – means are calculated using zeros for each time-step–even when no new data is recorded by a unit of space. This has a dampening effect because peaks are counterbalanced by periods of inactivity. It is therefore useful for identifying consistently high values.
Weighted – The weighting factors defined in the associated weighted value range will be used to scale the accumulated metric.

Note: If you are creating a 'Weighted Map' and intend to select Weighted Value Ranges on the 'Value and Colour Ranges' and or 'Alternative Value Ranges' tabs, you must select Weighted as the Accumulation Method.

Warning: Exponential Decay and Mean value with zeros may slow down the performance of an analysis and are best applied to a Zone rather than the Whole Model.

Reset Interval

If you would like to clear an active Map at certain time intervals, check the Enable box and enter a value in seconds in the Reset map every n seconds box.

Continue to Value and Colour Ranges.